The Compact Flash card on each node holds two Data ONTAP 10.0 software images. These images can be different; for instance, you can upgrade one image while retaining the current image, restart the node to run the new image, and either continue to run with the new image or, if you encounter problems, revert to the previous image.
To display information about currently installed software images, use the system image show command. The command displays the following information:
Name of the node on which the image is located
Image name
Whether the image is the default image (that is, the image that is run when the node starts)
Whether the image is the current image (that is, the image that is currently running on the node)
Software version
Installation date
The following example shows detailed information about the software images on a node named node8:
node::>system image show -instance -node node8Node: node8 Image Name: image1 Is Default Image: true Is Current Image: true Kernel Image Path: /cfcard/x86/freebsd/image1/kernel Root Filesystem Image Path: /cfcard/x86/freebsd/image1/rootfs.img Software Version: 10.0 Install Date: 3/10/2006 19:59:28 Node: node8 Image Name: image2 Is Default Image: false Is Current Image: false Kernel Image Path: /cfcard/x86/freebsd/image2/kernel Root Filesystem Image Path: /cfcard/x86/freebsd/image2/rootfs.img Software Version: 10.0 Install Date: 3/10/2006 20:00:48
To set the default software image (that is, the software image that is run when the node is restarted), use the system image modify command. When you set one of the node's software images as the default, the other image is automatically unset as the default. Conversely, if you unset a software image as the default, the other image is automatically set as the default.
The following example sets the image named image2 to be the default image on a filer named node8:
node::>system image modify -node node8 -image image2 -isdefault trueDefault Image Changed.
To upgrade or downgrade a software image, use the system image update command. The command requires the name of the node whose alternate software image (that is, the image that is not currently running) is to be updated and the FTP or HTTP URL from which the image is to be transferred. You can optionally specify the image that is to be replaced if the node is booted from the network and whether the newly updated image is to be set as the default image; at the advanced privilege level, you can specify whether to disable version-compatibility checking.
You can specify the URL from which the image is to be transferred in any of the following ways:
As an HTTP URL in the form http://host_name[:port]/path_to_file. For instance, http://now.netapp.com/downloads/software.tgz. The management utility prompts you for a user name and password before beginning the download.
If you use HTTP to transfer software images, be aware that the management utility does not check whether the Web server is password protected; if it is not, press Enter at the prompt for user name and password.
As an FTP URL in the form ftp://host_name[:port]/path_to_file. For instance, ftp://now.netapp.com/downloads/software.tgz. If required, the management utility prompts you for a user name and password before beginning the download.
As a TFTP URL in the form tftp://host_name[:port]/path_to_file. For example, tftp://internal-server/downloads/software.tgz. TFTP does not require a user name or password.
As a path to a mounted file system in the form file://path_to_file. For example, file://mnt/images/software.tgz.
If you use FTP or TFTP to transfer software images, you might or might not need to specify an extra slash (/) before the path_to_file specification, depending on how the FTP server is configured. If the FTP server is configured to use the server's root directory (/) as its home directory, no extra slash is needed; if the FTP server does not use the server's root directory as its home directory, you might need to use the extra slash, thereby specifying the full path name. For example, if you are transferring a software image named /downloads/software/DOT_10.0.tgz from an FTP server that does not use the server's root directory as its home directory, you need to specify the path ftp://ftp.example.com//downloads/software/DOT_10.0.tgz rather than ftp://ftp.example.com/downloads/software/DOT_10.0.tgz.
The following example updates the alternate software image on a node named node04 from the location http://www.example.com/downloads/software/DOT_10.0.tgz:
node::>system image update -node node04 -package http://www.example.com/downloads/software/DOT_10.0.tgzSoftware Image Updated.
You can display the progress of a software-image update by using the system image show-update-progress command, as in the following example:
node::>system image show-update-progress
The command displays progress until the update completes; you can also interrupt the command by pressing Ctrl-C.
If you need to perform a fresh installation of Data ONTAP 10.0 software (for instance, if you replace a Compact Flash card on a node), use the system image fresh-install command. The command requires the name of the node on which the image is to be installed and the FTP or HTTP URL where the image is located. See “Updating a Software Image” for a description of URL syntax.
The following example performs a fresh installation of a software image located at ftp://ftp.example.com//downloads/software/DOT_10.0 onto the Compact Flash card of a node named node05:
node::>system image fresh-install -node node05 -package ftp://ftp.example.com//downloads/software/DOT_10.0